package org.example.aienglishapp_login.mapper.login;

import org.apache.ibatis.annotations.Mapper;
import org.apache.ibatis.annotations.Param;
import org.example.aienglishapp_login.entity.login.UserProfile;
import org.springframework.stereotype.Repository;

/**
 * 用户个人资料映射接口。
 * <p>
 * 该接口定义了与用户个人资料相关的数据库操作方法，并使用 MyBatis 进行持久层的交互。
 *
 * @author xlj
 * @version 1.0
 * @since 2024-10-1
 */
@Mapper
@Repository
public interface UserProfileMapper {

    /**
     * 更新用户个人资料信息。
     *
     * @param userProfile 要更新的用户个人资料对象
     */
    void update(UserProfile userProfile);

    /**
     * 根据用户ID查询用户个人资料信息。
     *
     * @param userId 用户ID
     * @return 返回对应的用户个人资料对象，如果未找到则返回 null
     */
    UserProfile findByUserId(@Param("userId") Long userId);

    /**
     * 根据用户ID删除用户个人资料。
     *
     * @param userId 用户ID
     */
    void deleteByUserId(@Param("userId") Long userId);

    /**
     * 插入新的用户个人资料记录。
     *
     * @param userProfile 要插入的用户个人资料对象
     */
    void insert(UserProfile userProfile);
}